Drives Table

Prerequisites

Access Level:

User, Sub-admin, Admin

Permission Requirements

• . Basic Project Interaction
  • View projects they are a member of
  • View other members in projects they are a member of
  • Classify resources with projects they are active in
• . Project Management
  • Declassify resources tagged with projects they manage
• . Basic VM Interaction
  • View drives (inconsistent, see notes)
  • Create drives
  • Edit drives (name and whether to disable backup)
  • View drive keys (necessary to share/attach)
  • Share drives
  • Unshare drives
  • Attach drives to VMs
  • Detach drives from VMs
  • Delete drives they own

View Existing Drives

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. View all listed drives you have access to.

Access Drives from the Virtual Machines UI

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Virtual Machines section on the top left panel.
3. In the left panel, select the virtual machine to access its drive(s).
4. Scroll down and click the File Explorer option in the center.
5. In the new window, on the right panel select your Drive(s) (1, 2, ...).
6. View the contents of your drive(s).

Confirmations, Errors & Solutions

▶View More

Loading Drive Table Failed

Unable to perform action, missing permissions.

Ask Admin to Allow You to View Drives

Ask your admin to update your viewing drives permissions.

To Admin

To update drive viewing permission for a user:  

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Users section.
3. Click the Users in the top left panel.
4. Select the user whom open permissions you want to update.
5. Click the Open Full Menu button in the top right panel.
6. Select Open Overlay.
7. In the new window, navigate to Miscellaneous.
8. Click Manual permission management in the left panel.


9. Under, Basic VM Interaction tick the following permissions.
• View drives (inconsistent, see notes)
• View drive keys (necessary to share/attach)
10. Once done, click the Save button above.

Manage Drives from the Virtual Machines UI

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Virtual Machines section on the top left panel.
3. In the left panel, select the virtual machine to manage its drive(s).
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Drives section in the left panel.
6. Manage your drive(s) from the list.

Create a New Drive

Method one:

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Click the Create new drive in the top right corner.
4. In the prompt, enter the drive name and capacity in GB or TB.
5. Select the drive format from:
   EXT4 (Linux)
   BTRFS (Linux)
   NTFS (Windows).
   
6. Add an optional owner, team, optional project, and realm.
7. Click Create.

Method two:

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Virtual Machines section on the top left panel.
3. In the left panel, select the virtual machine to create a new drive in.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Drives section in the left panel.
6. Click Attach drive(s) icon in the top panel.
7. In the prompt, select Create a new drive.
8. In the prompt, enter the drive name and capacity in GB or TB.
9. Select the drive format from:
   EXT4 (Linux)
   BTRFS (Linux)
   NTFS (Windows).
   
10. Add an optional owner, team, optional project, and realm.
11. Click Create.

note

• Your drive capacity depends on your allocated team resources.
• Your drive format determines what kind of VM can be attached to the drive.
• Click the Advanced options button to set up permission management status, Cache & IO strategy for the drive.

Confirmations, Errors & Solutions

▶View More

Created Drive Successfully

Created drive drive-name.

Selected NTFS (Windows) Drive Format

NTFS drive names cannot be changed after creation due to Windows BitLocker restrictions. The encryption is tied to the device and its name. Please be cautious and choose drive names carefully during the creation process.

Did Not Select Optional Drive Owner

Leaving this blank means you will be the owner.

Enabled No Permission Management

In Create new drive prompt, under Advanced Options you selected Enable option.

If you select this option, tiCrypt will not manage permissions for this drive. No access directories can be created on the drive and the data is not available to regular users. This option is useful if you want applications such as databasaes to store their data on this drive.

Did Not Enter Drive Name

You must enter a name for the drive.

Enter Drive Name

In the Create new drive prompt, enter the drive name in the Name field.

Did Not Enter Drive Capacity

You must enter a capacity for the drive.

Enter Drive Capacity

In the Create new drive prompt, enter the drive capacity in the Capacity field.

Did Not Select Drive Team

You must select a team from the autocomplete.

Select Drive Team

In the Create new drive prompt, under Relation section, enter the drive team in the Team field.

Unable to Select Backup Settings

Your back-up settings are inactive upon drive creation.

Select Libvirt Realm

In the Create new drive prompt, under Realm section, select the realm to Libvirt. tiCrypt does not back up Nutanix realms in drives by default.

Unable to Create Drives

Drive creation failed: Unable to perform action, missing permissions.

Create Drive Button Inactive

Create button is inactive in Drive Creation prompt.

Ask Admin for Drive Creation Permissions

Ask your admin to allow you to create drives.

To Admin

To allow a user to create drives:

1. In the Management section, click the Users section in the left panel.
2. Select the appropriate user to update permissions.
3. Click the Open Overlay button in the top right.
4. In the new window, go to the Manual permission management section.
5. Under Basic VM Interaction section, tick the Create drives permission.
6. Once done, click Save in the top center.

Attach an Existing Drive to an Existing VM

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Virtual Machines section on the top left panel.
3. In the left panel, select the virtual machine to attach the drives to.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Drives section in the left panel.
6. Click Attach drive(s) icon in the top panel.
7. In the prompt, select Add a new drive.
8. Next, select the drive and the drive type.
9. Optionally, tick the box Add drive(s) to the VM configuration and share drive(s) with co-owners.
10. Click Attach and mount.
11. In the prompt, select Add a new drive.
12. Next, select the drive and the drive type.
13. Optionally, tick the box Add drive(s) to the VM configuration and share drive(s) with co-owners.
14. Click Attach and mount.

info

• A read-write drive can only be attached to a single VM. A read-only drive can be attached to multiple VMs.
• To automatically share the newly created or attched drive with the VM co-owners, tick Add drive(s) to the VM configuration and share drive(s) with co-owners box.

Confirmations, Errors & Solutions

▶View More

Attached Drive Successfully

Attach/mount drive-name to vm-name(total-attaching-time).

Unable to Attach Drive

Failed at attaching-time: cannot format/encrypt read-only drive: drive-name.

If the drive is re-attached read-only or read-write, the following error triggers in prompt.

Timeout Failure to Attach Drive

Failed at attaching-time: Timeout waiting for item drive-string-id to satisfy predicate.

Ask Drive Owner to Change Drive Team

You must ask the drive owner to change the drive team or increase the team quota for the drive-associated team.

To Drive Owner

To change drive team:  

1. In the Drives section, select the drive where you want to change the drive team.
2. Click the Edit drive button in the top panel list.
3. In the new window, under Relation section, select a new team.
4. Click Update.

To increase drive team quota follow the steps in  

Edit Teams' Quotas.

Missing Permissions To Attaach/Mount Drive

First attempt to attach/mount home drive failed (will retry once): Unable to perform this action, missing permissions.

Ask Admin to Allow You to Attach/Mount Drives

Ask your admin to update your attaching/mounting drives permissions.

To Admin

To update drive attach/mount permission for a user:  

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Users section.
3. Click the Users in the top left panel.
4. Select the user whom open permissions you want to update.
5. Click the Open Full Menu button in the top right panel.
6. Select Open Overlay.
7. In the new window, navigate to Miscellaneous.
8. Click Manual permission management in the left panel.


9. Under, Basic VM Interaction tick the following permissions.
View drives (inconsistent, see notes)
View drive keys (necessary to share/attach)
Attach drives to VMs
Detach drives from VMs
10. Once done, click the Save button above.

Remount an Existing Drive in an Existing VM

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Virtual Machines section on the top left panel.
3. In the left panel, select the virtual machine to remount the drive into.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Drives section in the left panel.
6. Select the drive(s) to remount.
7. Click the Remount drive(s) icon in the top panel.

Mount All Existing Drives in an Existing VM

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Virtual Machines section on the top left panel.
3. In the left panel, select the virtual machine to mount all drives into.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Drives section in the left panel.
6. Click Mount all Drives icon in the top panel.

Confirmations, Errors & Solutions

▶View More

Mounted All Drives Successfully

Mount all drives on vm-name (total-mounting-time).

Timeout Failure to Mount All Drives

Failed at mount-all-attaching-time: Timeout waiting for item drive-string-id to satisfy predicate.

Ask Drive Owner(s) to Change All Drive Types To Ready

You must ask the drive owner(s) to change all drives in VM to a ready state.

To Drive Owner
You cannot change states of ReadOnly or ReadWrite drives. If your drives failed to mount in VM, you must create a new drive from scratch. Additionally, you might want to migrate the unused drive(s) to a the different storage pool for data management.

To create a new drive follow the steps in  

Create a New Drive.

To migrate an existing drive to a different storage pool follow the steps in  

Migrate a Drive to a Different Storage Pool.

Detach a Drive from an Existing VM

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Virtual Machines section on the top left panel.
3. In the left panel, select the virtual machine to detach the drive from.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Drives section in the left panel.
6. From the list, select the drive you want to detach.
7. Click the Open Full Menu button by the selected drive in the left panel list.
8. Select Detach drive(s).
9. In the prompt, click Yes to proceed.

warning

Detaching a drive will revoke user access and stop applications from the drive.

Add or Change a Project in a Drive

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to add or change the project.
4. Click the Open Full Menu button in the top right corner.
5. Select Change project.
6. In the pop-up, select a project to tag the drive.
7. Click Classify.

tip

Check your changes in the drive. The project will display the project tag name by the drive in the list or in the drive details under drive owner name.

Confirmations, Errors & Solutions

▶View More

Did Not Select Any Project

No change made.

Classified Project in Drive

Classify drive-name to project-name(total-classifying-time).

Failed to Classify Project in Drive

Changing a project tag on a running VM does not take effect until the VM is restarted, even if the VM configuration reflects the updated project tag.

Failed to load LUKS header from device: invalid argument.

Ask the VM Owner to Restart VM

Ask the VM owner to restart the VM. Once the VM is restarted ensure you re-login to view the changes.

To Virtual Machine Owner
To restart the VM, follow the steps in 

Restart a Virtual Machine.

Forcefully Add or Change a Project in a Drive

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Click the Open Full Menu button in the top right corner.
4. Select Change project.
5. In the pop-up, tick Use my permission to override rules, re-tag resources with any visible project, regardless of current project relations.
6. Select any project to tag the drive.
7. Click Force change with admin privilege.

note

Forcefully tagging a drive with a project is only available to users with admin or super-admin roles in the system.

Remove a Project from a Drive

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Click the Open Full Menu button in the top right corner.
4. Select Change project.
5. In the pop-up, select No project (unlocked) to remove the project tag from drive.
6. Click Declassify.

note

If you are a super-admin and do not belong to the project, you can use the Force change with admin privilege option to forcibly remove a project tag.

Confirmations, Errors & Solutions

▶View More

Removed Project Successfully

Declassify drive-name completely (total-declassifying-time).

Share a Drive with Other Users

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to share.
4. Click the Open Full Menu button by the selected drive in the left panel list.
5. Select Share.
6. In the prompt, click the Share with a user button in the top right corner.
7. In the pop-up, enter and select the user names to share the drive with.
8. Click Share.
9. Once done, click Close.

Confirmations, Errors & Solutions

▶View More

Shared Drive Successfully

Shared with total-number-of-users user(s).

No Users to Share in Drive Share Prompt

This drive cannot be shared.

Attach the Drive to a Virtual Machine

The drive must be initialized and attached to a virtual machine before it can be shared.

Unable to Click Drive Share Button

Failed to look up keys for drive-name: Insufficient permissions to list drive keys for drive drive-string-id.

Ask Drive Owner(s) to Share the Drive

You must ask the drive owner(s) to share the drive with the user(s).

To Drive Owner
Your drive users cannot further share a home-drive that is read-write attached to a running VM. Only you can perform the drive share action.

Take extra-caution: Verify if the drive keys generated correctly upon VM creation.  

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to view its logs.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Logs section in the left panel.
6. View the last 50 logs entry.
7. Click Load Older to view older logs.
8. Look for an early error upon VM creation "error in homedriveattached function: failed to generate ssh host keys:failed to generate host key-id key: failed to generate key: exit status 255".
9. Once done, click Close.
10. Contact the system administrator for further inspection.

Give Full-Access (Read-Write) of a Drive to a User

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to give full-access to.
4. Click the Share button in the top panel.
5. In the prompt, select Full-access next to the shared user(s) in the right column.
6. Once done, click Close.

Confirmations, Errors & Solutions

▶View More

Shared Drive Successfully

Shared with total-number-of-users user(s).

Cannot Change Drive Owner Share Status to Full-Access

Failed to share drive: Failed to execute 'encrypt' on 'SubtleCrypto': The provided value is not of type '(ArrayBuffer or ArrayBufferView)'.

Ask the Drive Owner to Change Their Own Status

Regardless of the user role, only the drive owner can change their drive status.

Change Own Share Status to Full-Access in a Shared Ready Drive

Failed to share drive: Only users who own keys to a Drive may add additional keys.

Ask the Drive Owner to Reshare Drive With You

The drive owner shares a ready drive with you so you can attach it to a VM as instructed. If you change your share status to full-access before attaching the drive, you will lose access and the drive will disappear from your drive list. Either attach the ready drive to a VM yourself or ask the drive owner to do it for you.

Give Read-Only Access of a Drive to a User

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to give read-only access to.
4. Click the Share button in the top panel.
5. In the prompt, select Read-Only next to the shared user(s) in the right column.
6. Once done, click Close.

Confirmations, Errors & Solutions

▶View More

Shared Drive Successfully

Shared with total-number-of-users user(s).

Cannot Change Drive Owner Share Status to Read-Only

Failed to share drive: Failed to execute 'encrypt' on 'SubtleCrypto': The provided value is not of type '(ArrayBuffer or ArrayBufferView)'.

Ask the Drive Owner to Change Their Own Status

Regardless of the user role, only the drive owner can change their drive status.

Change Own Share Status to Read-Only in a Shared Ready Drive

Failed to share drive: Only users who own keys to a Drive may add additional keys.

Ask the Drive Owner to Reshare Drive With You

The drive owner shares a ready drive with you so you can attach it to a VM as instructed. If you change your share status to read-only before attaching the drive, you will lose access and the drive will disappear from your drive list. Either attach the ready drive to a VM yourself or ask the drive owner to do it for you.

Edit Drive Details

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to edit.
4. Click the Edit drive button in the top panel list.
5. In the prompt, edit the drive name, relation to team,project, or realm, backup settings and other advanced metadata.
6. Click Update.

Migrate a Drive to a Different Storage Pool

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to migrate.
4. Click the Migrate drive button in the top panel list.
5. In the prompt, select the destination pool.
6. Click Migrate.

Confirmations, Errors & Solutions

▶View More

Migrated Drive Successfully

Migrate drive-name total-migration-time.

Failed to Migrate Drive

Migrate drive-name Failed at migration-failure-time: migration-destination-pool-name.

Migrate Drive to a Different Migration Pool

The migration pool did not receive your drive. Ask the system administrator to review the migration pool and temporarily migrate the drive to a different migration pool.

Migration Button Inactive in Migrate Drive Prompt

The "Migrate" button in prompt is inactive for certain migration pools.

Ask the System Administrator To Create A New Migration Pool

The migration pool has reached its full space quota or is unable to receive additional drive migrations. Contact the system administrator to create a new migration pool for your existing drive.

Migration Button Inactive in Migrate Drive Prompt

Migrate drive-name total-migration-time Failed at failure-time: the server took longer than 30s to reply.

View The Drive State in Drive Table

In the State column, review the drive status. If the drive is transferring to an existing migration pool, the transfer process cannot be interrupted or redirected to another migration pool until completion.

Bulk Email All Drive Users

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to bulk email users.
4. Click the Open Full Menu button by the selected drive in the left panel list.
5. Select Bulk email.
6. In the prompt, click Download to download all drive user emails to your local machine.
7. Click Copy to copy all drive user emails to your clipoard.
8. Once done, click Close.

Confirmations, Errors & Solutions

▶View More

Copied Drive Email List Successfully

Email list copied to the clipboard.

Transfer Ownership of the Drive to a Different User

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to transfer ownership.
4. Click the Open Full Menu button by the selected drive in the left panel list.
5. Select Transfer ownership.
6. In the prompt, enter the new drive owner name.
7. Click Transfer.

info

To transfer drive ownership, you must first grant Full-access to the drive to the user(s) you want to transfer ownership to.

Confirmations, Errors & Solutions

▶View More

Shared Drive Successfully

Shared with total-number-of-users user(s).

Unable to Transfer Drive Ownership to You from Drive Owner

The owner has not shared this drive read-write with anyone.

Ask the Drive Owner to Share the Drive with You in Read-Write

Ask the drive owner to share the drive with you in full-access (read-write) mode so that you are able to transfer ownwership to yourself.

Unable to Transfer Drive Ownership to No Read-Write User

You have not shared the drive read-write with anyone.

Share the Drive Read-Write with At Least One User

Once you share the drive in full-access (read-write) mode with at least one user, you can transfer drive ownership to the shared user.

Unshare the Drive with a User

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top right panel.
3. Select the drive to unshare with a user.
4. Click the Share button in the top panel.
5. In the prompt, filter the users by name or email.
6. Click the Delete button by the user you want to remove from sharing the drive with.
7. Once done, click Close.

Confirmations, Errors & Solutions

▶View More

Unshared Drive Successfully

user-name no longer has access.

Unable to Unshare Drive from Drive Owner

Failed to unshare file from user-name(owner): The drive owner's key may not be removed.

Ask the Drive Owner to Transfer Drive Ownership

Regardless of the user role, only the drive owner can unshare the drive with themselves in a drive deletion scenario.

To Drive Owner
To transfer drive ownership to a different drive user follow the steps in  

Transfer Ownership of the Drive to a Different User

Change Own Share Status to Read-Only in a Shared Ready Drive

Failed to share drive: Only users who own keys to a Drive may add additional keys.

Ask the Drive Owner to Reshare Drive With You

The drive owner shares a ready drive with you so you can attach it to a VM as instructed. If you change your share status to read-only before attaching the drive, you will lose access and the drive will disappear from your drive list. Either attach the ready drive to a VM yourself or ask the drive owner to do it for you.

Unshare the Drive with All Users

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to unshare from everyone else.
4. Click the Open Full Menu button by the selected drive in the left panel list.
5. Select Unshare Drive from everyone else.

Confirmations, Errors & Solutions

▶View More

Unshared Drive From Everyone Else

Unshare drive-name from everyone else total-unsharing-time.

Delete the Drive

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to delete.
4. Click the Open Full Menu button by the selected drive in the left panel list.
5. Select Delete.
6. In the prompt, tick the drive(s) without errors to delete.
7. Type "Confirm" to confirm deletion.
8. Click Delete.

warning

You cannot delete drives actively attached to VMs. Shutdown the VM first, then delete the drive.

Confirmations, Errors & Solutions

▶View More

Deleted Drive Successfully

Delete drive-name total-deletion-time.

Undo Drive Deletion Successfully

total-undone-deletion-time Undone Deleting drive-name.

Drive Currently Attached

Drive currently attached to a VM.

Shut Down the VM

You must shutdown the VM or ask the VM owner to shut down the VM for you.

To VM Owner

To shut down the VM follow the steps in  

Shut Down a Virtual Machine.

Failed to Enter Confirmation Text

Type to Confirm.

Enter Confirmation Text

You must enter the same word "Confirm" in the Confirm field.

Unable to Delete Drives

All drives have errors.

Manually Remove Drives from VMs

1. Shut down all existing VMs where the drives with errors are located.
2. Open each VM separately, then remove the drives with errors.
3. Once done, verify the Drive currently attached to a VM error in the deletion drive prompt is cleared.
4. Proceed to drive deletion.

Access Drive Details

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to view its details.
4. Click the View button in the top panel.
5. In the new window, view drive name, format, project tag and team at the top.

View Drive Specifications

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to view its specifications.
4. Click the View button in the top panel.
5. In the new window, under Specification view the drive format, mounting options, capacity and attachment.

info

The drive format may be any of ext4, ntfs,btrfs,xfs or zfs.

View Drive Basic Information

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to view its basic information.
4. Click the View button in the top panel.
5. In the new window, scroll down to Basic Info section.
6. View the drive owner, backup, creation date & time and ID for debug purposes.

View Drive Shared Users and VMs

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to view its shared users and VMs.
4. Click the View button in the top panel.
5. In the new window, scroll down to Shared with users section.
6. View all users the drive is shared with.
7. Under Attached to VMs, view all VMs the drive is attached to.

Copy Drive ID

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to view ID.
4. Click the View button in the top panel.
5. In the new window, scroll down to Basic Info section.
6. Click the Copy button next to ID.
7. Paste the drive ID where necessary.

info

The drive ID is a string of numbers and letters such as 590c350a-7c5e-478e-88cf-6f35fd3b56bc.

Confirmations, Errors & Solutions

▶View More

Copied Drive ID Successfully

Value copied to the clipboard.

View Drives Data for JSON Export

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive(s) to view for JSON export.
4. Click the Export JSON button in the top right corner.
5. Select View selected items.
6. In the new prompt, click Expand all fields button in the top left panel.
7. View all JSON export data by ID, name, owner ID, owner, access, state, project-name-enhanced, team ID, team, size, format, backup, type, and raw.
8. Once done, click Close.

Download or Copy Drives Data in JSON

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive(s) to view for JSON export.
4. Click the Export JSON button in the top right corner.
5. Select View selected items.
6. In the new prompt, click Expand all fields button in the top left panel.
7. View all JSON export data by ID, name, owner ID, owner, access, state, project-name-enhanced, team ID, team, size, format, backup, type, and raw.
8. Click Copy to copy drive data to clipboard or click Download to download drive data locally.
9. Once done, click Close.

Export Drive Data in JSON Format

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive(s) to export in JSON format.
4. Click the Export JSON button in the top panel.
5. Next, select Export selected items.
6. In the new prompt, choose the export destination locally.
7. Click Save.

Export Drive Data in CSV Format

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive(s) to export in CSV format.
4. Click the Export CSV button in the top panel.
5. Select Export selected items.
6. In the new prompt, choose the export destination locally.
7. Click Save.

Prepare the Drive to Store Applications and Databases

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive to store applications and databases.
4. Click the Edit drive button in the top panel list.
5. In the prompt, click the Advanced Options button.
6. Change the permission management setting from Disable to Enable.
7. Click Update.

caution

Enabling permission management on a drive stops tiCrypt from managing drive permissions. No access directories can be created, and the data will not be available to regular users. This is useful for applications like databases that store large data.

Change the Cache Strategy of a Drive

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive for which you want to change the cache strategy.
4. Click the Edit drive button in the top panel list.
5. In the prompt, click the Advanced Options button.
6. Change the cache strategy from default to none, writethrough, writeback, or directsync.
7. Click Update.

Change the IO Strategy of a Drive

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Drives section on the top left panel.
3. Select the drive for which you want to change the IO strategy.
4. Click the Edit drive button in the top panel list.
5. In the prompt, click the Advanced Options button.
6. Change the IO strategy from default to threads or native.
7. Click Update.

tip

Use dedicated threads when handling many concurrent IO operations. Use native when dealing with high-performance databases or large-scale storage systems.

Change Drive Capacity & Type

You cannot change the capacity and type of a drive. You must create a new drive from scratch.

info

Transfer the drive to a new migration pool or move all data to a larger drive.